Skip to content

docs: document saved Photo selections and optional approval - #599

Merged
Rui-Sun merged 3 commits into
mainfrom
codex/photo-selection-four-repos-20261111
Nov 11, 2026
Merged

Rui-Sun merged 3 commits into
mainfrom
codex/photo-selection-four-repos-20261111

Conversation

@Rui-Sun

@Rui-Sun Rui-Sun commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

同步 Photo 图文选择的操作指引:新候选默认全选、改选须保存、Approve 仅作审计,人工 Merge 后仅处理已保存的所选基准。旧人工基准流程明确限定为未启用或无可用清单的情况,避免重复写入;GitHub 分支保护、原报告和未知请求恢复要求保持。

本 PR 作为 VBI 四仓扩展的精确验收目标,已转 Ready,按现有单重型调度执行。文档合入不代表全量开放,实际能力以维护者明确配置为准;Bot 不代为 Approve 或 Merge。

验证:

  • 本轮只改 Markdown;git diff --check 与本地文档链接路径检查通过。
  • 已同步贡献指南及相关基准流程;适用仓库的 PR 模板和状态说明一并修正。
  • 当前提交的 CR、CI、Playwright 与 Photo 以本 PR 对应最新 SHA 的回执为准;不沿用旧 head 的结果。
  • 本轮纯文档修正未在本地重跑产品构建/视觉测试;完整验证交由 CI 与工作流执行。

VisActor 工作流(CN):completed

当前提交:4019e28ebd536bc492ac2fae91efcf0aca7d231c

三项检查建议与 BugServer 人工确认

@Rui-Sun
Rui-Sun marked this pull request as ready for review November 11, 2026 08:10

@visactor-review-bot visactor-review-bot Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

最新复查提交: 4019e28

未发现可确认的新问题。

Comment thread CONTRIBUTING.zh-CN.md
### 批准、合入和异常恢复

工作流识别具有仓库 Maintain/Admin 权限的维护者对**当前提交**作出的有效 GitHub Approve,该批准同时表示已人工核查 Photo。Bot 不自动 Approve/Merge;GitHub 分支保护和其他检查仍适用,工作流不新增强制 Checks 或修改仓库规则。
工作流中的 GitHub Approve 仅作审计;维护者核对当前提交的 CR、单测、Playwright 和 Photo 后,可以直接手动 Merge。GitHub 分支保护或仓库评审要求仍然适用,Bot 不会修改这些规则,也不会代为 Approve 或 Merge。

@visactor-review-bot visactor-review-bot Bot Nov 11, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] 同步可选批准后的状态与版本操作指引

对已启用图文选择、且仓库规则允许直接合入的 PR,这里允许维护者核查后不作 Approve 就 Merge;但同页状态表仍写“等待人工合入”须识别当前提交的有效批准,第 72 行仍写新提交需要有效批准,英文版也保留相同要求。维护者按状态表处理时会继续等待或请求一次不再必要的批准,也无法据此判断当前版本何时可合入。请为可选批准的 PR 明确状态与新提交处理方式,并同步两种语言的操作指引。


已确认修复 (4019e28): 已复查原触发条件:允许不作 GitHub Approve 而手动合入的流程下,中英文状态表的“等待人工合入”现均要求核对三项建议、Photo 和保存修订,不再要求识别当前提交的有效批准;两版新提交指引也改为重新核对当前结果与保存修订。原先会让维护者继续等待批准的文档冲突已消失,仓库评审规则的适用边界仍被保留。

Comment thread CONTRIBUTING.zh-CN.md
Photo 自动差异评估及标准图自动更新暂停。Approve/Merge 不授权自动采用测试图;提前合入不会使未完成或失败的检查变为通过。新增/修改共享基准需管理员另行获得明确授权、人工核查并安排复验,原报告保留。
对已明确启用图文选择的 PR,BugServer 展示当前版本的图片和短说明,新候选默认全选。维护者应逐项核查;需要保留旧基准的项目取消选择,并在合入前保存成功。以服务端显示的保存修订为准,未保存草稿不生效;已保存的人工选择不会被默认全选覆盖。

合入后只更新该修订已选的基准,未选项不变。写入前仍核对冻结提交、三项检查、实际合入内容、保存时间及原基准;旧版本、合入后补选或冲突不能自动补认。请求超时或部分成功时联系维护者按原任务恢复,不重新派发或更换请求 ID。

@visactor-review-bot visactor-review-bot Bot Nov 11, 2026 •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P2] 为图文选择模式更新仍要求手工写入基准的指南

已启用图文选择的 PR 在合入前保存修订后,这里明确说工作流只更新所选基准;但同仓 packages/vseed/__tests__/visual/BUGSERVER_CASE_WORKFLOW.md 第 29–33 行仍无条件要求管理员另行取得授权、手工更新并安排新的 Photo 复验,还写明“工作流不自动建立或更新基准”;PR 模板也写“不自动…更新基准”。维护者从视觉指南进入该流程时可能在工作流写入后重复操作共享基准,或将正常更新误判为不应发生。请给旧流程及模板增加图文选择模式的适用边界,说明何时仍需人工处理。


已确认修复 (4019e28): 已复查原触发条件及从视觉指南和 PR 模板进入的调用路径:用例协作指南现把启用图文选择时的已保存修订更新,与未启用或无可用清单时的人工流程明确分开,并说明结果未知时不得另行手工重复写入;中英文模板和视觉指南也写明图文选择适用边界。原先会引导维护者对已自动处理的共享基准再走人工更新的无条件要求已消失。

@visactor-review-bot

visactor-review-bot Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

VisActor 工作流

结论:流程已完成。
当前提交:4019e28;比较基线:1cac2ef。
环境:CN;更新时间:2026-11-11T10:38:48.633Z。

检查项 状态 关键结果
CR ✅ passed 待处理 0;接受风险 0 查看结果
单测 ✅ passed 必要单测 job 必须实际执行并成功 查看结果
Playwright ✅ passed 截图 4;匹配 4;差异 0(已解释 0);错误 0
Photo(原 BugServer / UNIC) ✅ passed 用例 808;截图 824;匹配 824;差异 0(已解释 0);错误 0

Photo 独立报告:流程完成不代表 Photo 通过。 差异解释不决定接受;合入前保存的选择可在人工 Merge 后更新基准,Photo 不阻断合入。

请核对 BugServer 默认全选清单,改选后保存,再手动 Merge;Approve 可选,仅记录操作。
Bot 仅提供 CR、单测、Playwright 三项检查建议,不强制阻止合入。
未 Approve,可直接 Merge。

Photo 基准选择尚未保存;不影响三项检查建议或人工合入。
等待完整报告及逐项解释;没有有效授权时不更新基准。

Photo 执行明细

Photo 原始执行:completed;结果:passed;缺少基准 0;等待 0;运行中 0;不完整 0;创建未知 0。

Photo 差异解释(非阻断建议)

差异共 0 项;已逐项分析 0 项;未分析 0 项。
分析状态:全部差异已分析。以标准图为认可效果;仅解释差异和可能原因,不判断可接受、不建议更新基准。结论仅适用于下列已分析任务,不代表其余差异已验证,不改变 Photo 原始结果。

图片差异解释(0 项)

暂无已解释差异。

合入后 Photo 基准更新清单

没有已授权的基准更新。

版本与合入后状态

当前提交:4019e28ebd536bc492ac2fae91efcf0aca7d231c;比较基线:1cac2efa414afd4a1909aaf089c1453e0f4ca2aa。

合入后状态:skipped。

CN 结果仅证明上述实际范围;完整报告和原始差异继续保留。

@Rui-Sun
Rui-Sun merged commit 0e581c0 into main Nov 11, 2026
6 checks passed
@Rui-Sun
Rui-Sun deleted the codex/photo-selection-four-repos-20261111 branch November 11, 2026 10:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant